<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>Renaming the BLOB file feature to External Files</title>
    <link rel="stylesheet" href="gettingStarted.css" type="text/css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
    <link rel="start" href="index.html" title="Berkeley DB Installation and Build Guide" />
    <link rel="up" href="upgrade_62_toc.html" title="Chapter 9.  Upgrading Berkeley DB 12.1.6.1 applications to Berkeley DB 12.1.6.2" />
    <link rel="prev" href="upgrade_slices.html" title="Database Slices" />
    <link rel="next" href="upgrade_regiondir.html" title="Configurable Region Directory" />
  </head>
  <body>
    <div xmlns="" class="navheader">
      <div class="libver">
        <p>Library Version 12.1.6.2</p>
      </div>
      <table width="100%" summary="Navigation header">
        <tr>
          <th colspan="3" align="center">Renaming the BLOB file feature to External Files</th>
        </tr>
        <tr>
          <td width="20%" align="left"><a accesskey="p" href="upgrade_slices.html">Prev</a> </td>
          <th width="60%" align="center">Chapter 9.  Upgrading Berkeley DB 12.1.6.1 applications to Berkeley DB 12.1.6.2 </th>
          <td width="20%" align="right"> <a accesskey="n" href="upgrade_regiondir.html">Next</a></td>
        </tr>
      </table>
      <hr />
    </div>
    <div class="sect1" lang="en" xml:lang="en">
      <div class="titlepage">
        <div>
          <div>
            <h2 class="title" style="clear: both"><a id="renaming_blobs_external"></a>Renaming the BLOB file feature to External Files</h2>
          </div>
        </div>
      </div>
      <div class="toc">
        <dl>
          <dt>
            <span class="sect2">
              <a href="renaming_blobs_external.html#idm140188017622128">Functions</a>
            </span>
          </dt>
          <dt>
            <span class="sect2">
              <a href="renaming_blobs_external.html#idm140188017571904">New Parameter Values</a>
            </span>
          </dt>
          <dt>
            <span class="sect2">
              <a href="renaming_blobs_external.html#idm140188017574352">New Statistics</a>
            </span>
          </dt>
        </dl>
      </div>
      <p>
	    The BLOB file feature has been renamed to
	    <span class="emphasis"><em>external files</em></span> to avoid
	    confusion with the SQL datatype BLOB.  The functions and flags
	    associated with BLOBs have been deprecated, and new functions
	    have been added to replace them.  Existing applications that
	    use the old functions will still work, but users are
	    encouraged to use the new functions.
	</p>
      <p>
	    Below is a list of the deprecated
	    functions, flags, and statistics, along with the replacements.
	</p>
      <div class="sect2" lang="en" xml:lang="en">
        <div class="titlepage">
          <div>
            <div>
              <h3 class="title"><a id="idm140188017622128"></a>Functions</h3>
            </div>
          </div>
        </div>
        <div class="itemizedlist">
          <ul type="disc">
            <li><code class="literal"><a href="../api_reference/C/set_blob_dir.html" class="olink">DB-&gt;set_ext_file_dir()</a></code> replaces
		    <code class="literal">DB-&gt;get_blob_dir</code>.
		</li>
            <li><code class="literal"><a href="../api_reference/C/get_blob_threshold.html" class="olink">DB-&gt;get_ext_file_threshold()</a></code> replaces
		    <code class="literal">DB-&gt;get_blob_threshold</code>.
		</li>
            <li><code class="literal"><a href="../api_reference/C/set_blob_dir.html" class="olink">DB-&gt;set_ext_file_dir()</a></code> replaces
		    <code class="literal">DB-&gt;set_blob_dir</code>.
		</li>
            <li><code class="literal"><a href="../api_reference/C/set_blob_threshold.html" class="olink">DB-&gt;set_ext_file_threshold()</a></code> replaces
		    <code class="literal">DB-&gt;set_blob_threshold</code>.
		</li>
            <li><code class="literal"><a href="../api_reference/C/envget_blob_dir.html" class="olink">DB_ENV-&gt;get_ext_file_dir()</a></code> replaces
		    <code class="literal">DB_ENV-&gt;get_blob_dir</code>.
		</li>
            <li><code class="literal"><a href="../api_reference/C/envget_blob_threshold.html" class="olink">DB_ENV-&gt;get_ext_file_threshold()</a></code> replaces
		    <code class="literal">DB_ENV-&gt;get_blob_threshold</code>.
		</li>
            <li><code class="literal"><a href="../api_reference/C/envset_blob_dir.html" class="olink">DB_ENV-&gt;set_ext_file_dir()</a></code> replaces
		    <code class="literal">DB_ENV-&gt;set_blob_dir</code>.
		</li>
            <li><code class="literal"><a href="../api_reference/C/envset_blob_threshold.html" class="olink">DB_ENV-&gt;set_ext_file_threshold()</a></code> replaces
		    <code class="literal">DB-&gt;set_blob_threshold</code>.
		</li>
          </ul>
        </div>
      </div>
      <div class="sect2" lang="en" xml:lang="en">
        <div class="titlepage">
          <div>
            <div>
              <h3 class="title"><a id="idm140188017571904"></a>New Parameter Values</h3>
            </div>
          </div>
        </div>
        <div class="itemizedlist">
          <ul type="disc">
            <li><code class="literal">DB_LOG_EXT_FILE</code> replaces
		    <code class="literal">DB_LOG_BLOB</code> as a
		    <code class="literal">flags</code>
		    parameter value for the <a href="../api_reference/C/envlog_set_config.html" class="olink">DB_ENV-&gt;log_set_config()</a> method.
		</li>
            <li><code class="literal">DB_DBT_EXT_FILE</code> replaces
		    <code class="literal">DB_DBT_BLOB</code> as a
		    <code class="literal">flags</code>
		    parameter value for the <a href="../api_reference/C/dbt.html" class="olink">DBT</a> method.
		</li>
          </ul>
        </div>
      </div>
      <div class="sect2" lang="en" xml:lang="en">
        <div class="titlepage">
          <div>
            <div>
              <h3 class="title"><a id="idm140188017574352"></a>New Statistics</h3>
            </div>
          </div>
        </div>
        <p>
		<a href="../api_reference/C/dbstat.html" class="olink">DB-&gt;stat()</a> now includes the following fields to replace
		the old fields in the returned statistical structure.
	    </p>
        <div class="itemizedlist">
          <ul type="disc">
            <li><code class="literal">hash_ext_files</code> replaces
		    <code class="literal">hash_nblobs</code></li>
            <li><code class="literal">heap_ext_files</code> replaces
		    <code class="literal">heap_nblobs</code></li>
            <li><code class="literal">bt_ext_files</code> replaces
		    <code class="literal">bt_nblobs</code></li>
          </ul>
        </div>
      </div>
    </div>
    <div class="navfooter">
      <hr />
      <table width="100%" summary="Navigation footer">
        <tr>
          <td width="40%" align="left"><a accesskey="p" href="upgrade_slices.html">Prev</a> </td>
          <td width="20%" align="center">
            <a accesskey="u" href="upgrade_62_toc.html">Up</a>
          </td>
          <td width="40%" align="right"> <a accesskey="n" href="upgrade_regiondir.html">Next</a></td>
        </tr>
        <tr>
          <td width="40%" align="left" valign="top">Database Slices </td>
          <td width="20%" align="center">
            <a accesskey="h" href="index.html">Home</a>
          </td>
          <td width="40%" align="right" valign="top"> Configurable Region Directory</td>
        </tr>
      </table>
    </div>
  </body>
</html>
